home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir42 / flexx10.zip / FLEXX.MAN < prev    next >
Text File  |  1994-01-23  |  14KB  |  547 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                          FLEXX Data File Comparison
  20.  
  21.                              PROGRAM DESCRIPTION
  22.  
  23.                                     and
  24.  
  25.                          OPERATING CONSIDERATIONS
  26.  
  27.  
  28.                                 Version 1.0
  29.  
  30.                             Copyright (c) 1993
  31.  
  32.  
  33.  
  34.                                     F$OFT
  35.                         Financial Software Engineering
  36.                             14015 NE 87th Street
  37.                           Redmond, WA 98052-1952
  38.                               (206) 881-1968
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                     Page   1
  60.  
  61.  
  62.  
  63.  
  64.  
  65. FILES:
  66.  
  67.         FLEXX.EXE - The executable program for performing data file
  68.                     comparisons.
  69.  
  70.         FLEXX.MAN - This document.
  71.  
  72.         ORDER.DOC - Document explaining the hardware and operating
  73.                     environment requirements for FLEXX and contains
  74.                     registration form for the program.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                                     Page   2
  118.  
  119.  
  120.  
  121.  
  122. FLEXX Overview
  123.  
  124.         FLEXX is designed for a maximum of capabilities and a minimum of
  125.         operational involvement.  FLEXX provides a quick and flexible method
  126.         of performing data file comparisons necessary during software
  127.         conversions.  The process consists of having the original data file
  128.         and the converted data file resident on the PC hard drive.  This is
  129.         accomplished by either downloading the files from a mainframe
  130.         computer or loading the files from floppy disks.  Any technique that
  131.         will place both files on the PC to be used for the comparison is
  132.         acceptable.
  133.  
  134.         FLEXX will compare data in individual fields (record segments),
  135.         report on differences within each field and, if a synchronized
  136.         compare is requested, identify the addition or deletion of records
  137.         contained in the two files.
  138.  
  139.         Maximum record size currently allocated by FLEXX is 400 bytes.  Any
  140.         file containing records that are 400 bytes or shorter may be compared
  141.         using FLEXX.  If you have the need to compare files with record sizes
  142.         greater than 400 bytes, the size may be increased for registered users
  143.         of FLEXX by contacting F$OFT at the address or telephone number shown
  144.         on the cover page.  A $10.00 fee will be assessed which includes
  145.         modification, media, shipping and handling.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.                                     Page   3
  176.  
  177.  
  178.  
  179.  
  180. OPERATING INSTRUCTIONS:
  181.  
  182.         Assumption:
  183.  
  184.         1. You wish to identify differences that may exist in two comparable
  185.            data files.
  186.  
  187.         2. The FLEXX program, the original file and the converted file are
  188.            all in located in the same directory.
  189.  
  190.         Action:
  191.  
  192.         1. FLEXX is activated by typing:
  193.  
  194.                 FLEXX and pressing the (ENTER/RETURN key)
  195.  
  196.         2. A registration reminder screen will be displayed.  Pressing the
  197.            ENTER key will allow the program to continue.
  198.  
  199.  
  200.         3. The next screen will be the FILE INPUT screen shown below.
  201.  
  202.           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  203.           *                                                           *
  204.           *    Enter the name of the ORIGINAL File   [            ]   *
  205.           *                                                           *
  206.           *    Enter the name of the NEW File        [            ]   *
  207.           *                                                           *
  208.           *    Enter the name of the REPORT File     [            ]   *
  209.           *                                                           *
  210.           *                                                           *
  211.           *    [ ] When all names are correct, enter a Y              *
  212.           *                                and press ENTER.           *
  213.           *                                                           *
  214.           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  215.  
  216.           Enter the names of the files to be compared and the name of the
  217.           report file to be created during the execution of the FLEXX program.
  218.           Each file name may contain a total of 12 characters, this includes
  219.           the period when using a file extension.  Fewer than 12 characters
  220.           is permissible.  Move from one entry to the next by pressing the
  221.           TAB key, do not use the ENTER key until all entries are complete.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.                                     Page   4
  234.  
  235.  
  236.  
  237.  
  238.           Example:
  239.                         ORIGNIAL.DAT
  240.  
  241.           When all file names and report name is entered, continue to the next
  242.           step by entering a Y in the lower left hand box and press the
  243.           ENTER/RETURN key.
  244.  
  245.         4. The FLEXX program will check the current directory to validate the
  246.            presence of each of the input files entered on the previous screen.
  247.            If either of the files is not found, the following screen is
  248.            displayed.
  249.  
  250.                    * * * * * * * * * * * * * * * * * * * *
  251.                    *                                     *
  252.                    *   Requested File                    *
  253.                    *                                     *
  254.                    *           ORIGINAL.DAT              *
  255.                    *                                     *
  256.                    *               Does not exist.       *
  257.                    *                                     *
  258.                    *   Press ENTER to continue.          *
  259.                    *                                     *
  260.                    * * * * * * * * * * * * * * * * * * * *
  261.  
  262.            NOTE: The REPORT file is not validated, a duplicate name will
  263.                  cause an existing file to be overwritten.
  264.  
  265.            If you are notified of a missing file, press the ENTER/RETURN key.
  266.            You will be returned to the FILE INPUT screen where you will be
  267.            allowed to correct the mistake and continue by pressing the
  268.            ENTER/RETURN key.
  269.  
  270.            Should you need to discontinue the FLEXX program and return to
  271.            the DOS prompt, hold down the CTRL key and press the letter C.
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.                                     Page   5
  292.  
  293.  
  294.  
  295.  
  296.         5. The OPTIONS Screen will display next.
  297.  
  298.           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  299.           *                                                             *
  300.           *  OPTIONS - Select the desired options, press the Home key   *
  301.           *                          [ ]                enter a Y and   *
  302.           *                          press the ENTER key to continue.   *
  303.           *                                                             *
  304.           *                                                             *
  305.           *  [ ] Synchronized Compare?                                  *
  306.           *                                                             *
  307.           *  Start the File compare with record number     [      ]     *
  308.           *                                                             *
  309.           *  Terminate the File compare with record number [      ]     *
  310.           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  311.  
  312.           A. Synchronized Compare?
  313.  
  314.              If you wish to confirm the addition or deletion of records
  315.              between the two files, enter a Y in this box.  FLEXX will then
  316.              report any differences of records.  If the difference is found
  317.              in the ORIGINAL File, the record will be reported as "MISSING".
  318.              If the difference is found in the NEW file, the record is
  319.              reported as "ADDED".
  320.  
  321.              A synchronized compare can only be performed on files that are
  322.              sorted in ascending order on a defined control field.  The
  323.              control field is always F1 on the INPUT DATA Screen.
  324.  
  325.              If synchronized compare is not desired, press the HOME key,
  326.              enter the letter Y in the OPTIONS area and press the
  327.              ENTER/RETURN key.
  328.  
  329.           B. Start the File compare with record number:
  330.  
  331.              It is not necessary to compare entire files if areas of concern
  332.              have been previously isolated to a range of records.  Place the
  333.              record number of the first record to be compared in this field,
  334.              FLEXX will begin the compare process at the selected record.
  335.              A value of 000000 in this field will cause FLEXX to begin the
  336.              file comparison with record number 1.
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.                                     Page   6
  350.  
  351.  
  352.  
  353.  
  354.           C. Terminate the File compare with record number:
  355.  
  356.              Place the record number of the last record to be included in
  357.              the compare process.  A value of 000000 will cause FLEXX to
  358.              compare all records until an END OF FILE condition is
  359.              encountered.
  360.  
  361.           NOTE: Beginning and Ending record entries are valid for all file
  362.                 comparisons.
  363.  
  364.                 The placement of the letter Y in the OPTIONS area of this
  365.                 screen without entering any data in the boxes below will
  366.                 allow FLEXX to compare the entire file contents.
  367.  
  368.           When you are satisfied with the options selected and entered on
  369.           the OPTIONS screen, press the HOME key, enter the letter Y and
  370.           press the ENTER/RETURN key to continue.
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.                                     Page   7
  408.  
  409.  
  410.  
  411.  
  412.         6. The INPUT DATA screen will display:
  413.  
  414.  
  415.      [ ] When input data is complete, Press the HOME key,
  416.                                       enter a Y and press ENTER.
  417.  
  418.                       Define the fields to be compared.
  419.                  Maximum single field length is 35 positions.
  420.  
  421.  
  422.                OLD FILE DATA:                      NEW FILE DATA:
  423.      F1  START POS. [   ] LENGTH [  ]    F1  START POS. [   ] LENGTH [  ]
  424.      F2  START POS. [   ] LENGTH [  ]    F2  START POS. [   ] LENGTH [  ]
  425.      F3  START POS. [   ] LENGTH [  ]    F3  START POS. [   ] LENGTH [  ]
  426.      F4  START POS. [   ] LENGTH [  ]    F4  START POS. [   ] LENGTH [  ]
  427.      F5  START POS. [   ] LENGTH [  ]    F5  START POS. [   ] LENGTH [  ]
  428.      F6  START POS. [   ] LENGTH [  ]    F6  START POS. [   ] LENGTH [  ]
  429.      F7  START POS. [   ] LENGTH [  ]    F7  START POS. [   ] LENGTH [  ]
  430.      F8  START POS. [   ] LENGTH [  ]    F8  START POS. [   ] LENGTH [  ]
  431.      F9  START POS. [   ] LENGTH [  ]    F9  START POS. [   ] LENGTH [  ]
  432.      F10 START POS. [   ] LENGTH [  ]    F10 START POS. [   ] LENGTH [  ]
  433.      F11 START POS. [   ] LENGTH [  ]    F11 START POS. [   ] LENGTH [  ]
  434.      F12 START POS. [   ] LENGTH [  ]    F12 START POS. [   ] LENGTH [  ]
  435.  
  436.            A field length of 35 positions is necessary due to the fact that
  437.            the report is designed to be printed on 80 column paper width.
  438.  
  439.            F1 is the control field identifier when performing a synchronized
  440.            compare.  Each field thereafter may be entered in random order.
  441.            FLEXX will automatically adjust to field length differences in
  442.            the two files therefore it is not necessary to assure that the
  443.            field sizes are equal.
  444.  
  445.            Non synchronized compares do not require a control field
  446.            identifier, entries may be in any order that makes the analysis
  447.            process easier for you the user.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                     Page   8
  466.  
  467.  
  468.  
  469.  
  470.         Assumptions:
  471.  
  472.           1. You are familiar with the field positions of both files to be
  473.              compared by FLEXX.
  474.  
  475.           2. You know the length of each field to be compared.
  476.  
  477.         Action:
  478.  
  479.           1. Enter the starting position of the first field on the F1 line.
  480.              A start position in the ORIGINAL FILE of 1 will be entered
  481.              as 001.
  482.  
  483.           2. Enter the length of this field.
  484.              A length of 4 in the ORIGINAL FILE will be entered as 04.
  485.  
  486.           3. Enter the starting position of the compare field on the F1 line.
  487.              A start position in the NEW FILE of 52 will be entered as 052.
  488.  
  489.           4. Enter the length of this field.
  490.              A length of 10 in the NEW FILE will be entered as 10.
  491.  
  492.           5. Continue this process until you have identified all of the
  493.              fields to be compared or you have exhausted all 12 compare keys.
  494.  
  495.           6. To begin the compare process, press the HOME key, enter the
  496.              letter Y in the [ ] box and press the ENTER/RETURN key.
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.                                     Page   9
  524.  
  525.  
  526.  
  527.  
  528.         7. Report printing.
  529.  
  530.                 The compare report will be found in the current directory
  531.                 by the name you assigned on the FILES SCREEN.  To print this
  532.                 report:
  533.  
  534.                 Type PRINT <report name>
  535.  
  536.                          or
  537.  
  538.                      TYPE <report name> > LPT1
  539.  
  540.                 where <report name> is the assigned report name such as -
  541.                    COMPARE.REP.  The < and > are not part of the DOS command.
  542.  
  543.                 The DOS command will appear as:
  544.  
  545.                         TYPE COMPARE.REP > LPT1
  546.  
  547.